home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmVaCreateSimplePopupMenu.z / XmVaCreateSimplePopupMenu
Encoding:
Text File  |  2003-11-18  |  10.2 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333UUUUXXXXNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_P_o_p_u_p_M_e_n_u - A    RowColumn widget convenience
  10.       creation function
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <Xm/RowColumn.h>
  14.  
  15.       Widget XmVaCreateSimplePopupMenu (ppppaaaarrrreeeennnntttt,,,, nnnnaaaammmmeeee,,,, ccccaaaallllllllbbbbaaaacccckkkk,,,, aaaarrrrgggg............)
  16.            _W_i_d_g_e_t     ppppaaaarrrreeeennnntttt;
  17.            _S_t_r_i_n_g     nnnnaaaammmmeeee;
  18.            _X_t_C_a_l_l_b_a_c_k_P_r_o_cccccaaaallllllllbbbbaaaacccckkkk;
  19.  
  20.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.       _X_m_V_a_C_r_e_a_t_e_S_i_m_p_l_e_P_o_p_u_p_M_e_n_u creates an instance    of a RowColumn
  22.       widget of type _X_m_M_E_N_U__P_O_P_U_P and returns the associated
  23.       widget ID.  This routine uses    the ANSI C variable-length
  24.       argument list    (varargs) calling convention.
  25.  
  26.       This routine creates a Popup MenuPane    and its    button
  27.       children.  The name of each button is    button_nnnn, where    nnnn is
  28.       an integer from 0 to one minus the number of buttons in the
  29.       menu.     The name of each separator is separator_nnnn, where nnnn is
  30.       an integer from 0 to one minus the number of separators in
  31.       the menu.  The name of each title is label_nnnn,    where nnnn    is an
  32.       integer from 0 to one    minus the number of titles in the
  33.       menu.     Buttons, separators, and titles are named and created
  34.       in the order in which    they are specified in the variable
  35.       portion of the argument list.
  36.  
  37.       ppppaaaarrrreeeennnntttt
  38.            Specifies the widget ID of the parent of    the MenuShell
  39.  
  40.       nnnnaaaammmmeeee Specifies the name of the created widget
  41.  
  42.       ccccaaaallllllllbbbbaaaacccckkkk
  43.            Specifies a callback procedure to be called when    a
  44.            button is activated or when its value changes.  This
  45.            callback    function is added to each button after
  46.            creation.  For a    CascadeButtonGadget or a
  47.            PushButtonGadget, the callback is added as the button's
  48.            _X_m_N_a_c_t_i_v_a_t_e_C_a_l_l_b_a_c_k, and    it is called when the button
  49.            is activated.  For a ToggleButtonGadget,    the callback
  50.            is added    as the button's    _X_m_N_v_a_l_u_e_C_h_a_n_g_e_d_C_a_l_l_b_a_c_k, and
  51.            it is called when the button's value changes.  The
  52.            button number is    returned in the    cccclllliiiieeeennnntttt____ddddaaaattttaaaa field.
  53.  
  54.       The variable portion of the argument list consists of    groups
  55.       of arguments.     The first argument in each group is a
  56.       constant or a    string and determines which arguments follow
  57.       in that group.  The last argument in the list    must be    NULL.
  58.       Following are    the possible first arguments in    each group of
  59.       varargs:
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333UUUUXXXXNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333XXXX))))
  71.  
  72.  
  73.  
  74.       _X_m_V_a_C_A_S_C_A_D_E_B_U_T_T_O_N
  75.            This is followed    by two additional arguments.  The set
  76.            specifies one button in the PopupMenu and some of its
  77.            resource    values.     The button created is a
  78.            CascadeButtonGadget.  Following are the additional two
  79.            arguments, in this order:
  80.  
  81.       llllaaaabbbbeeeellll
  82.            The label string, of type XmString.
  83.  
  84.       mmmmnnnneeeemmmmoooonnnniiiicccc
  85.            The mnemonic, of    type KeySym.  This is followed by four
  86.            additional arguments.  The set specifies    one button in
  87.            the PopupMenu and some of its resource values.  The
  88.            button created is a PushButtonGadget.  Following    are
  89.            the additional four arguments, in this order:
  90.  
  91.       llllaaaabbbbeeeellll
  92.            The label string, of type XmString.
  93.  
  94.       mmmmnnnneeeemmmmoooonnnniiiicccc
  95.            The mnemonic, of    type KeySym.
  96.  
  97.       aaaacccccccceeeelllleeeerrrraaaattttoooorrrr
  98.            The accelerator,    of type    String.
  99.  
  100.       aaaacccccccceeeelllleeeerrrraaaattttoooorrrr____tttteeeexxxxtttt
  101.            The accelerator text, of    type XmString.    This is
  102.            followed    by four    additional arguments.  The set
  103.            specifies one button in the PopupMenu and some of its
  104.            resource    values.     The button created is a
  105.            ToggleButtonGadget.  Following are the additional four
  106.            arguments, in this order:
  107.  
  108.       llllaaaabbbbeeeellll
  109.            The label string, of type XmString.
  110.  
  111.       mmmmnnnneeeemmmmoooonnnniiiicccc
  112.            The mnemonic, of    type KeySym.
  113.  
  114.       aaaacccccccceeeelllleeeerrrraaaattttoooorrrr
  115.            The accelerator,    of type    String.
  116.  
  117.       aaaacccccccceeeelllleeeerrrraaaattttoooorrrr____tttteeeexxxxtttt
  118.            The accelerator text, of    type XmString.    This is
  119.            followed    by four    additional arguments.  The set
  120.            specifies one button in the PopupMenu and some of its
  121.            resource    values.     The button created is a
  122.            ToggleButtonGadget.  Following are the additional four
  123.            arguments, in this order:
  124.  
  125.       llllaaaabbbbeeeellll
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333UUUUXXXXNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333XXXX))))
  137.  
  138.  
  139.  
  140.            The label string, of type XmString.
  141.  
  142.       mmmmnnnneeeemmmmoooonnnniiiicccc
  143.            The mnemonic, of    type KeySym.
  144.  
  145.       aaaacccccccceeeelllleeeerrrraaaattttoooorrrr
  146.            The accelerator,    of type    String.
  147.  
  148.       aaaacccccccceeeelllleeeerrrraaaattttoooorrrr____tttteeeexxxxtttt
  149.            The accelerator text, of    type XmString.    This is
  150.            followed    by one additional argument.  The pair
  151.            specifies a title LabelGadget in    the PopupMenu.
  152.            Following is the    additional argument:
  153.  
  154.       ttttiiiittttlllleeee
  155.            The title string, of type XmString.  This is followed
  156.            by no additional    arguments.  It specifies one separator
  157.            in the PopupMenu.  This is followed by no additional
  158.            arguments.  It specifies    one separator in the
  159.            PopupMenu.  The separator type is _X_m_D_O_U_B_L_E__L_I_N_E.     This
  160.            is followed by one additional argument, the value of
  161.            the resource, of    type XtArgVal.    The pair specifies a
  162.            resource    and its    value for the RowColumn    widget.     This
  163.            is followed by four additional arguments.  The set
  164.            specifies a resource and    its value for the RowColumn
  165.            widget.    A resource type    conversion is performed    if
  166.            necessary.  Following are the additional    four
  167.            arguments, in this order:
  168.  
  169.       nnnnaaaammmmeeee The resource name, of type String.
  170.  
  171.       ttttyyyyppppeeee The type    of the resource    value supplied,    of type
  172.            String.
  173.  
  174.       vvvvaaaalllluuuueeee
  175.            The resource value (or a    pointer    to the resource    value,
  176.            depending on the    type and size of the value), of    type
  177.            XtArgVal.
  178.  
  179.       ssssiiiizzzzeeee The size    of the resource    value in bytes,    of type    int.
  180.            This is followed    by one additional argument of type
  181.            XtVarArgsList.  This argument is    a nested list of
  182.            varargs returned    by _X_t_V_a_C_r_e_a_t_e_A_r_g_s_L_i_s_t.
  183.  
  184.       For more information on variable-length argument lists, see
  185.       the X    Toolkit    Intrinsics documentation.
  186.  
  187.       A number of resources    exist specifically for use with    this
  188.       and other simple menu    creation routines.  For    a complete
  189.       definition of    RowColumn and its associated resources,    see
  190.       _X_m_R_o_w_C_o_l_u_m_n(_3_X).
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                        (printed 11/11/03)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333UUUUXXXXNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVVVVVaaaaCCCCrrrreeeeaaaatttteeeeSSSSiiiimmmmpppplllleeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu((((3333XXXX))))
  203.  
  204.  
  205.  
  206.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  207.       Returns the RowColumn    widget ID.
  208.  
  209.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  210.       _X_m_C_r_e_a_t_e_P_o_p_u_p_M_e_n_u(_3_X), _X_m_C_r_e_a_t_e_R_o_w_C_o_l_u_m_n(_3_X),
  211.       _X_m_C_r_e_a_t_e_S_i_m_p_l_e_P_o_p_u_p_M_e_n_u(_3_X), and _X_m_R_o_w_C_o_l_u_m_n(_3_X).
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                        (printed 11/11/03)
  262.  
  263.  
  264.  
  265.